Adds getAccountResources() method to Wallet class for querying account resources from the WP API endpoint.

Changes

• Interface (iWallet.ts): Added GetAccountResourcesOptions interface and method signature to IWallet interface
• Implementation (wallet.ts): Implemented method with options object pattern, array validation and query parameter handling in Wallet class
• Tests (wallet/getAccountResources.ts): Added unit tests covering success paths and error cases

Method Signature

async getAccountResources(params: GetAccountResourcesOptions): Promise<any>

Where GetAccountResourcesOptions is defined as:

export interface GetAccountResourcesOptions {
  addresses: string[];
  destinationAddress?: string;
}

Calls GET /accountResources with addresses as a required parameter and optional destinationAddress for computing resource deficits needed for an asset transfer.

Usage

// Access via wallet instance
const resources = await wallet.getAccountResources({ 
  addresses: ['addr1', 'addr2'] 
});

// Query with destination address to get resource deficit for a token transfer
const resources = await wallet.getAccountResources({ 
  addresses: ['TWpHQPy2CBwJ5opNF1ugRY357vMDPNLEGK'],
  destinationAddress: 'TUXzc3sUuTqNDeKCbhiKtcVUfSvgTtRpzz'
});

Example Output

Running against a testnet USDT wallet (ttrx:usdt):

{
  "resources": [
    {
      "address": "TWpHQPy2CBwJ5opNF1ugRY357vMDPNLEGK",
      "free_bandwidth_available": 600,
      "free_bandwidth_used": 0,
      "staked_bandwidth_available": 0,
      "staked_bandwidth_used": 0,
      "energy_available": 0,
      "energy_used": 0,
      "resourceDeficitForAssetTransfer": {
        "bandwidthDeficit": 0,
        "bandwidthSunRequired": "0",
        "energyDeficit": 28045,
        "energySunRequired": "1993"
      },
      "maxResourcesDelegatable": {
        "bandwidthWeight": "0",
        "energyWeight": "0"
      }
    }
  ],
  "failedAddresses": []
}

Key fields explained:

• free_bandwidth_available / staked_bandwidth_available: Bandwidth from free daily allocation and TRX staking respectively.
• energy_available: Energy the address currently has (from staking or delegation).
• resourceDeficitForAssetTransfer: The shortfall in bandwidth and energy needed for a token transfer to the destination address. Here the address needs 28,045 energy (costing 1,993 SUN ≈ 0.001993 TRX) to perform a USDT transfer, but has no bandwidth deficit.
• maxResourcesDelegatable: The maximum bandwidth/energy weight this address can delegate to others (zero here since nothing is staked).